home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Development Libraries / SGI IRIX 6.5 Development Libraries.iso / dist / inst_dev.idb / usr / share / catman / u_man / cat1 / swpkg.z / swpkg
Text File  |  1998-05-04  |  15KB  |  331 lines
  1.  
  2.  
  3.  
  4. sssswwwwppppkkkkgggg((((1111MMMM))))                                                            sssswwwwppppkkkkgggg((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      swpkg - SGI product packager
  10.  
  11. UUUUSSSSAAAAGGGGEEEE
  12.      sssswwwwppppkkkkgggg [[[[ ----nnnnooooffffoooorrrrkkkk _n_o_f_o_r_k ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _S_w_p_k_g is a Motif based tool used to package software for iiiinnnnsssstttt,,,, the
  16.      Silicon Graphics installation program.  Swpkg provides an environment for
  17.      creating and updating ssssppppeeeecccc and iiiiddddbbbb files and running ggggeeeennnnddddiiiisssstttt((((1111MMMM))))....
  18.  
  19.      A spec file defines the products that will be turned into a software
  20.      distribution by gendist. It gives the names of the products, their iiiimmmmaaaaggggeeeessss
  21.      and ssssuuuubbbbssssyyyysssstttteeeemmmmssss,,,, information about the contents of those subsystems, and
  22.      the installation procedure and environment they require.  Installation
  23.      database (idb) files contain one line of information for every file,
  24.      directory, link, and fifo in a product.
  25.  
  26.  
  27.      Options:
  28.  
  29.      ----nnnnooooffffoooorrrrkkkk _n_o_f_o_r_k
  30.                Run in foreground rather than the background.
  31.  
  32.  
  33.      The tab panel across the top of the main window controls the view:
  34.  
  35.           Create Product Hierarchy
  36.           Tag Files
  37.           Edit Permissions and Destinations
  38.           Add Attributes
  39.           Build Product
  40.  
  41.      The spec file is constructed in the first step, and gendist is run in the
  42.      last.  The other steps construct the idb file.  Both files are saved to
  43.      disk for gendist to read in the final step.
  44.  
  45.      The FFFFiiiilllleeee pulldown menu on the upper left includes items for reading and
  46.      writing spec and idb files:
  47.  
  48.           Open
  49.           Read
  50.           New
  51.           Save
  52.           SaveAs
  53.           Quit
  54.  
  55.      The QQQQuuuuiiiitttt menu item terminates the session.  Selecting any of the other
  56.      items cascades another menu from which you can select Spec, Idb, or Both.
  57.      For example, Open->Both will bring up a file selection dialog for a spec
  58.      file and then another dialog for identifying an idb file.  By convention,
  59.      spec filenames end in '.spec', and idb filenames end with '.idb'.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssswwwwppppkkkkgggg((((1111MMMM))))                                                            sssswwwwppppkkkkgggg((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      RRRReeeeaaaadddd appends an existing spec or idb, while OOOOppppeeeennnn replaces.  NNNNeeeewwww---->>>>SSSSppppeeeecccc
  75.      opens the default spec, and NNNNeeeewwww---->>>>IIIIddddbbbb clears the idb of all entries.  So
  76.      NNNNeeeewwww---->>>>BBBBooootttthhhh gets you back to the initial state.
  77.  
  78.      The SSSSaaaavvvveeee and SSSSaaaavvvveeeeAAAAssss items are for writing the in memory copies of the idb
  79.      and spec files to disk.  If you opened or saved previously, the SSSSaaaavvvveeee
  80.      operation writes to the file you identified.  The SaveAs operation brings
  81.      up a file selection dialog so you can identify an arbitrary pathname to
  82.      save too.
  83.  
  84.      All of the file menu items log a message in the scrollable window below
  85.      the tab panel.  The number of lines of the log displayed are controlled
  86.      using the sash (square button below the scrollbar).  The VVVViiiieeeewwww menu pane
  87.      contains an item (Show Messages) which makes it possible to shrink the
  88.      message area to nothing.  When an important message is logged, the
  89.      message area will reappear.
  90.  
  91.      The HHHHeeeellllpppp menu pane (on the far right) provides an interface to online
  92.      help facilities.  Selecting an item from this menu fires off the Insight
  93.      help server if it is not already running, and provides access to the book
  94.      which documents Swpkg if installed.
  95.  
  96.      The CCCClllliiiicccckkkk ffffoooorrrr HHHHeeeellllpppp item can be selected to turn the cursor into a
  97.      question mark, which can be clicked on any widget for context sensitive
  98.      help on a particular item in the interface.  Alternatively, you can
  99.      simply press <F1> while the normal cursor is over the widget you want
  100.      information about.
  101.  
  102.  
  103.      CCCCrrrreeeeaaaatttteeee PPPPrrrroooodddduuuucccctttt HHHHiiiieeeerrrraaaarrrrcccchhhhyyyy
  104.  
  105.      The initial view shows a graphical representation of a default spec file.
  106.      The information related to the selected node in the three level
  107.      (product.image.subsystem) hierarchy appears on the right.
  108.  
  109.      Alter the PPPPrrrroooodddduuuucccctttt NNNNaaaammmmeeee and DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn fields and press the AAAAppppppppllllyyyy arrow
  110.      button to assign this information to the product node, which is selected
  111.      initially.  The Description field is what users of inst see when your
  112.      product is presented for installation by inst.  To select another node,
  113.      click on it with the left mouse button.
  114.  
  115.      The AAAAdddddddd pushbutton can be pressed to add a child to the currently
  116.      selected node.  If your on a first level (product) node, pressing Add
  117.      will create a new second level (image) node.  Similiarly, if an image
  118.      node is selected, when you press the the Add pushbutton you create a new
  119.      third level (subsystem) node.  To add another product, click on the root
  120.      (the area around the nodes), and then press the Add pushbutton.
  121.  
  122.      The DDDDeeeelllleeeetttteeee pushbutton will remove the subtree rooted at the selected
  123.      node.  So, for example, if there are no release notes for your product,
  124.      you should click the left mouse button on the "relnotes" node, and press
  125.      "Delete".
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. sssswwwwppppkkkkgggg((((1111MMMM))))                                                            sssswwwwppppkkkkgggg((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      TTTTaaaagggg FFFFiiiilllleeeessss
  141.  
  142.      A file browser, and list of tags appear on the left, while the tags and
  143.      source paths of each idb file entry appear on the right.
  144.  
  145.      The initial browsing directory is the current directory, provided it's
  146.      within the source root directory (defaults to /).  Entering ~ will take
  147.      you to your $HOME directory.  Entries in the browser list ending with /
  148.      are directories.  Double-clicking on a directory entry takes you there.
  149.  
  150.      A Single click on an entry selects it.  Multiple contiguous entries can
  151.      be selected by pressing and dragging the mouse before releasing the left
  152.      button.  You can select separate entries by holding down the <CTRL> key
  153.      when pressing the left mouse button.
  154.  
  155.      To add the entries selected, press the AAAAdddddddd arrow button.  The entries
  156.      will be associated with the current selection in the the Tags list.  To
  157.      Assign a different tag subsequently, select the entries in the idb file
  158.      list, and the tag you want to associate with them, and press the AAAAssssssssiiiiggggnnnn
  159.      arrow button.
  160.  
  161.      Tags for each subsystem defined in the spec, and those defined in the
  162.      current idb are included in the tags list.  Below the tags list is a text
  163.      field that can be used in conjunction with the buttons to edit the list.
  164.      To add a new tag, type a value into the text field, and hit <Enter>, or
  165.      press the AAAAdddddddd pushbutton.  Pressing RRRReeeeppppllllaaaacccceeee will replace the tag
  166.      currently selected, and the DDDDeeeelllleeeetttteeee pushbutton will remove the current
  167.      selection from the list.
  168.  
  169.      Double clicking on a tag selects the Idb file list items assoicated with
  170.      that tag.  Double clicking on an entry in the Idb file list selects the
  171.      tag associated with that item.
  172.  
  173.      EEEEddddiiiitttt PPPPeeeerrrrmmmmiiiissssssssiiiioooonnnnssss aaaannnndddd DDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnssss
  174.  
  175.      The SSSSoooouuuurrrrcccceeee RRRRooooooootttt and DDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnn RRRRooooooootttt appear framed with an associated
  176.      AAAAppppppppllllyyyy button on the upper left.  Both default to /.  Changing the source
  177.      root directory limits the browsing area (in the Tag Files view) to the
  178.      designated tree.  The root is stripped from all pathnames added.  If you
  179.      have a tree of files users will install to a different destination, roots
  180.      are handy.  The final (Build Product) step includes a matching pair of
  181.      textfields for convenience when your rebuilding with no changes to your
  182.      spec or idb files.
  183.  
  184.      Note, the roots do not live in the spec or idb file, so they must be
  185.      respecified each time you start a new session.
  186.  
  187.      When you AAAAppppppppllllyyyy a new Source Root Directory value, it is first prepended
  188.      to the source pathname of each Idb entry.  If all entries are found, the
  189.      new root is accepted.  Otherwise, if the old root is valid (it can be
  190.      prepended to all the entries), it is prepended and if the new root
  191.      appears at the beginning of all entries it is accepted; the new root is
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. sssswwwwppppkkkkgggg((((1111MMMM))))                                                            sssswwwwppppkkkkgggg((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      stripped from all the source pathnames.
  207.  
  208.      When a new Source Root value is accepted, if the source and destination
  209.      pathnames matched beforehand, the destination pathname is changed to
  210.      reflect the new root too.  So if you edited any destination pathnames
  211.      prior to changing the source root, these will not be altered by the
  212.      operation.
  213.  
  214.      Text fields for MMMMooooddddeeee,,,, OOOOwwwwnnnneeeerrrr,,,, GGGGrrrroooouuuupppp,,,, DDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnn DDDDiiiirrrreeeeccccttttoooorrrryyyy,,,, and
  215.      DDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnn FFFFiiiilllleeeennnnaaaammmmeeee appear on the left, while the same fields of the
  216.      current Idb file entries are visible on the right.
  217.  
  218.      To edit, enter a value in one or more of the text fields, select the
  219.      entries you want to affect in the Idb list, and press the AAAAssssssssiiiiggggnnnn arrow
  220.      button to initiate the change.
  221.  
  222.      Double clicking on an Idb file list item will load its values into the
  223.      text fields.  This is convenient when your changing a single entry
  224.      (double click, alter, and Assign back).
  225.  
  226.      AAAAdddddddd AAAAttttttttrrrriiiibbbbuuuutttteeeessss
  227.  
  228.      A list of attributes appears on the left, while the destination paths and
  229.      any attributes are visible in the Idb file list.  Each entry in the
  230.      attribute list has a toggle button associated with it.  When the AAAAssssssssiiiiggggnnnn
  231.      arrow button is pressed, all those entries whose toggle is set are
  232.      assigned to the Idb file list items selected.  Pre-existing attributes
  233.      are deleted and the new ones added for each.
  234.  
  235.      Double clicking on an item in the Idb file list loads its attributes.
  236.  
  237.      BBBBuuuuiiiilllldddd PPPPrrrroooodddduuuucccctttt
  238.  
  239.      In this view, the arguments to a gendist run appear on the left, along
  240.      with buttons for the possible ways to run it.  On the right, all the
  241.      fields of each Idb file entry are visible.
  242.  
  243.      The DDDDrrrryyyy RRRRuuuunnnn pushbutton will run gendist which reads the files, and check
  244.      their validity, without writing anything.  The BBBBuuuuiiiilllldddd AAAAllllllll pushbutton
  245.      creates the files in the DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn DDDDiiiirrrreeeeccccttttoooorrrryyyy.... These include binary
  246.      versions of the idb and spec (a file for each subsystem), as well as an
  247.      image:
  248.  
  249.      -rw-rw-r--    1 kirke    user      404 Jun 28 16:11 swpkg
  250.      -rw-rw-r--    1 kirke    user      461 Jun 28 16:11 swpkg.idb
  251.      -rw-rw-r--    1 kirke    user     8509 Jun 28 16:11 swpkg.man
  252.      -rw-rw-r--    1 kirke    user   462834 Jun 28 16:11 swpkg.sw
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. sssswwwwppppkkkkgggg((((1111MMMM))))                                                            sssswwwwppppkkkkgggg((((1111MMMM))))
  269.  
  270.  
  271.  
  272. ENVIRONMENT VARIABLES
  273.      SBASE   Source Root
  274.      RBASE   Destination Root
  275.  
  276.  
  277. FFFFIIIILLLLEEEESSSS
  278.      ~/.Xdefaults
  279.      /usr/lib/X11/app-defaults/Swpkg
  280.      /usr/lib/X11/schemes/Base/Swpkg
  281.      /usr/sbin/gendist
  282.      /usr/dist
  283.  
  284.  
  285. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  286.      gendist(1M), inst(1M), showprod(1M),
  287.      _I_R_I_X _I_n_t_e_r_a_c_t_i_v_e _D_e_s_k_t_o_p _I_n_t_e_g_r_a_t_i_o_n _G_u_i_d_e
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.